home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfstrget.z / pxfstrget
Encoding:
Text File  |  1998-10-30  |  4.2 KB  |  81 lines
  1. PXFSTRGET(3F)                                          Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFSSTTRRGGEETT - Allows values stored in individual components of a
  6.      structure to be extracted and used
  7.  
  8. SSYYNNOOPPSSIISS
  9.      IINNTTEEGGEERR _j_h_a_n_d_l_e,, _i_l_e_n,, _i_e_r_r_o_r
  10.      CCHHAARRAACCTTEERR*(_n) _c_o_m_p_n_a_m,, _v_a_l_u_e
  11.      CCAALLLL PPXXFFSSTTRRGGEETT ((_j_h_a_n_d_l_e,, _c_o_m_p_n_a_m,, _v_a_l_u_e,, _i_l_e_n,, _i_e_r_r_o_r)
  12.  
  13. IIMMPPLLEEMMEENNTTAATTIIOONN
  14.      UNICOS, UNICOS/mk, and IRIX systems
  15.  
  16. SSTTAANNDDAARRDDSS
  17.      IEEE standard interface for FORTRAN 77
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  21.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  22.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  23.      7.2 F77 compiler.
  24.  
  25.      The routine PPXXFFSSTTRRGGEETT allows character values stored in individual
  26.      components of a structure to be extracted and used.
  27.  
  28.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  29.      UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
  30.      unless documented otherwise.  On UNICOS and UNICOS/mk, default kind is
  31.      KKIINNDD==88 for integer, real, complex, and logical arguments; on IRIX, the
  32.      default kind is KKIINNDD==44.
  33.  
  34.      The following are arguments to PPXXFFSSTTRRGGEETT:
  35.  
  36.      _j_h_a_n_d_l_e   An input integer that references a structure.  _j_h_a_n_d_l_e
  37.                should have been created with PPXXFFSSTTRRUUCCTTCCRREEAATTEE.
  38.  
  39.      _c_o_m_p_n_a_m   An input character variable that is the name of a component
  40.                of the structure.  _c_o_m_p_n_a_m is case-sensitive.
  41.  
  42.      _v_a_l_u_e     An output character variable.  Upon successful completion,
  43.                _v_a_l_u_e is set to the value stored in the component of _j_h_a_n_d_l_e
  44.                referenced by _c_o_m_p_n_a_m.  If the length of the data being
  45.                stored is less than the declared length of _v_a_l_u_e, _v_a_l_u_e is
  46.                padded with blanks.
  47.  
  48.                The structures and components that may be accessed through
  49.                PPXXFFSSTTRRGGEETT are described on the man page for the related PPXXFF
  50.                routine.  For example, the PPXXFFUUNNAAMMEE man page describes the
  51.                components for the _u_t_s_n_a_m_e structure.
  52.  
  53.      _i_l_e_n      An output integer variable.  _i_l_e_n is set to the actual
  54.                length of the data assigned to _v_a_l_u_e.  If the length of
  55.                _v_a_l_u_e is insufficient to contain the data being returned,
  56.                the data is truncated, and _i_l_e_n contains the original length
  57.                of the data before truncation.  In this case, _i_e_r_r_o_r is set
  58.                to EETTRRUUNNCC.
  59.  
  60.      _i_e_r_r_o_r    An output integer variable.  Upon successful completion of
  61.                PPXXFFSSTTRRGGEETT, _i_e_r_r_o_r is set to 0.  If any of the following
  62.                conditions occur, _i_e_r_r_o_r is set to the corresponding value:
  63.  
  64.                EENNOONNAAMMEE        Component name is not defined for the
  65.                               specified structure.
  66.  
  67.                EETTRRUUNNCC         The actual length of the data to be copied to
  68.                               _v_a_l_u_e was longer than the declared length of
  69.                               _v_a_l_u_e.
  70.  
  71.                EEBBAADDHHAANNDDLLEE     If _j_h_a_n_d_l_e is an invalid handle or has an
  72.                               incorrect handle type (UNICOS and UNICOS/mk
  73.                               systems only).
  74.  
  75. SSEEEE AALLSSOO
  76.      PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F), PPXXFFUUNNAAMMEE(3F)
  77.  
  78.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  79.      2165, for the printed version of this man page.
  80.  
  81.